home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 49 / Amiga Format CD49 (2000-01-17)(Future Publishing)(GB)(Track 1 of 3)[!][issue 2000-02].iso / -serious- / programming / mui / mcc_popph / mcc_popph_src / mcc_popph.readme < prev    next >
Text File  |  1999-11-30  |  6KB  |  154 lines
  1. WWW:      http://amiga.com.pl/mcc/
  2. Source:   dev/mui/MCC_Popph_Src.lha
  3.  
  4.  
  5.   Short
  6.   -----------------------------------
  7.  
  8.   Popplaceholder class is a simple but useful class ;) Most applications
  9.   are fully configurable nowadays, offering wide range of various
  10.   parameters for further user modifications.  Not only functions options
  11.   or forms of behaviour are configurable but often most of program
  12.   strings can now be changed by the user.  The latter applies to
  13.   internet (communication) related programs mostly, (e.g.  AmIRC,
  14.   AmTelnet, YAM and so on...) which needs to send various string to
  15.   other different people.  So they allow you to define e.g.  own welcome
  16.   phrase or kick reason sentence.  Because e.g.  your welcome phrase for
  17.   e.g.  John and phrase for Mary will differ only with the name, most of
  18.   these strings uses so called placeholders, to describe varable,
  19.   dynamically modified string part (e.g.  mentioned receipient name).
  20.   For example "On %d, %u wrote:".  The "%d" and "%u" ares just the
  21.   placeholders, program will replace on use by for instance mail date
  22.   and the sender's name (of course placeholder can look like "@name" or
  23.   "%{date}" or "my lovely grandma", but the idea behind remains).
  24.  
  25.   Unfortunately, most programs forces user to know what placeholder can
  26.   be user where and which means what.  That's kinda user unfriendly
  27.   (especially for beginners, or just-users).  Instead of forcing them to
  28.   type placeholders by hand (in proper syntax!) it would be nicer to let
  29.   them pick up what they want from the list of available items.  That
  30.   both eliminates placeholder syntax problems (unless user 'fix' it
  31.   later by hand of course) as well as disallows to use unsupported
  32.   placeholder (the above exception applies of course).  And here comes
  33.   Popplaceholder class.  It features the ordinary string gadget user can
  34.   type own text in, but it also gives the popup listview, which holds
  35.   all available placeholders.  User can easily select one from the list
  36.   either by double click or by neat Drag&Drop.  See the example demo
  37.   program for better picture of the class' features.
  38.  
  39.  
  40.   Popplaceholder is freeware software, but it's copyrighted
  41.   © 1999 by Marcin Orlowski <carlos@amiga.com.pl>
  42.  
  43.   PS: Yes, I know my english sucks ;)
  44.  
  45.  
  46.   Software using this class:
  47.   -----------------------------------
  48.  
  49.   - AmIRC 3
  50.   - AmTelnet 2
  51.   - OpenURL 3
  52.   - Voyager 3
  53.  
  54.   Let me know about your!
  55.  
  56.  
  57.   History
  58.   -----------------------------------
  59.  
  60.   14.0 (Mon Jul 12 10:15:34 1999)
  61.        - initial version
  62.  
  63.   14.1 (Mon Jul 12 13:09:21 1999)
  64.        - Added MUIA_Poplaceholder_Copy attribute
  65.        - now forwards all list object methods
  66.          to internal pop up list, increasing
  67.          flexibility
  68.  
  69.   14.2 (Tue Jul 13 19:35:58 1999)
  70.        - shortened all these "MUIx_Popplaceholder_#?"
  71.          to "MUIx_Popph_#?" for easier programming ;)
  72.        - added Drag&Drop feature
  73.  
  74.   14.3 (Wed Jul 14 14:05:34 1999)
  75.        - first public release
  76.        - wrote autodocs
  77.        - added support for existing string gadget
  78.          replacements (the fallback scheme looks like:
  79.          Textinput -> Betterstring -> original String)
  80.        - MUIA_Popph_StringMaxLen is gettable now
  81.  
  82.   14.4 (oops, I forgot the datestamp)
  83.        - added support for popup menu when Textinput
  84.          subclass is used
  85.        - added MUIA_Popph_ReplaceMode attribute
  86.  
  87.   14.5 (Sun Jul 25 19:58:25 1999)
  88.        - Popplaceholder is now 2-in-1 custom class
  89.          (poplaceholderstr.mcc is now useless and
  90.          should be wiped out of your disks)
  91.        - added some internal checks to avoid possible
  92.          problems with tag/descriptions being longer
  93.          than predefined max length
  94.        - Popph object is no longer higher than highest
  95.          object it uses
  96.        - MUIA_Popph_StringType added
  97.        - all TI/BS/String attrubutes are now forwarded
  98.          to internal string object on OM_SET/OM_GET.
  99.          Just talk to Popph as to string gadget
  100.        - added PopAsl alike work mode
  101.  
  102.   14.6 (Tue Jul 27 16:09:44 1999)
  103.        - MUIA_Version, MUIA_Revision are now supported
  104.        - fixed bad enforcer hit "implemented" in 14.5
  105.        - MUIA_Popph_Avoid added
  106.        - added MUIA_Popph_StringObject, MUIA_Popph_ListObject
  107.  
  108.   14.7 (Tue Aug 31 10:28:35 1999)
  109.        - all list methods and attributes are now forwarded
  110.          to internal list object. Handle with care.
  111.        - public release
  112.  
  113.   15.0 (Sat Nov 06 17:32:28 1999)
  114.        - now handles the entry even it's incorrect (e.g.
  115.          plain string, w/o separators etc) for easier
  116.          debugging (and wider usage ;-)
  117.        - added MUIA_Popph_PopCycleChain attribute on
  118.          mouse lovers' request (Grzegorz Kraszewski)
  119.        - PopPH now correctly handles ASLFR_DrawersOnly, TRUE
  120.          case in ASL mode (Troels Walsted Hansen)
  121.        - added MUIA_Popph_Title for easy popup list titles
  122.        - added single column mode
  123.  
  124.   15.1 (Tue Nov 23 23:25:45 1999)
  125.        - fixed MUIA_Popph_Avoid not working correctly
  126.          (uh, I forgot his name ;-( Will add later, sorry)
  127.        - pop buttons removed from the cycle chain
  128.          (MUIA_Popph_PopCycleChain is now FALSE by default)
  129.          as MUI offers special hotkey (CTRL-P by default)
  130.          for that, and won't break the AdvanceOnCR adventages
  131.          (Grzegorz Kraszewski)
  132.        - full source code released. Read source.readme for
  133.          closer details
  134.  
  135.  
  136.  
  137.           ___  ___  ___    ________    ___  ___  ___    ___  ___
  138.          /   \/   \/   \  /        \  /   \/   \/   \  /   \/   \
  139.         /    /    /    / /         / /    /    /    / /    /    /
  140.        /    /    /    / /    _____/ /    /    /    / /    /    /
  141.       /    /    /    / /        \  /    /    /    / /         /
  142.      /    /    /    / /         / /    /    /    / /         /
  143.     /    /    /    / /    _____/ /    /    /    / /    /    /
  144.    /    /    /    / /    /      /    /    /    / /    /    /
  145.    \___/\___/\___/ /    /       \___/\___/\___/  \___/\___/
  146.                   /    /
  147.                   \___/                    W.F.M.H. on-line
  148.                                          http://wfmh.org.pl
  149.  
  150.                Amiga software: http://amiga.com.pl/
  151.  
  152.  
  153.    $Id: MCC_Popph.readme,v 1.3 1999/11/16 20:58:11 carlos Exp $
  154.